Inside Macintosh: QuickDraw GX Objects /

Chapter 2 - Shape Objects / Shape Objects Reference

Functions / Manipulating Shape Object Properties

GXGetShapeOwners

You can use the GXGetShapeOwners function to determine the number of references to a particular shape object.

long GXGetShapeOwners(gxShape source);

source

A reference to the shape to find the owner count of.

function result

The owner count of the source shape.

DESCRIPTION

The GXGetShapeOwners function returns as its function result the current number of references to the shape object.

ERRORS, WARNINGS, AND NOTICES

Errors
shape_is_nil

SEE ALSO

Owner counts for shape objects are discussed in the section "Copying, Comparing, and Cloning Shape Objects" beginning on page 2-25, and in the section "Manipulating a Shape Object's Owner Count" beginning on page 2-31.

To increment the owner count of a shape, use the GXCloneShape function, described on page 2-61. To decrement the owner count of a shape, use the GXDisposeShape function, described on page 2-55.